More additions

svn path=/trunk/; revision=18336

diff --git a/docs/reference/gtk/tmpl/gtkbuilder.sgml b/docs/reference/gtk/tmpl/gtkbuilder.sgml
index b89357a80dd2fda86f8d5a26da5a438f021dec09..6f5b5481a65fee2461fd865ee99f7ec688592df5 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkbuilder.sgml
+++ b/docs/reference/gtk/tmpl/gtkbuilder.sgml
@@ -164,9 +164,14 @@ child, even if it has already been constructed.
 <para>
 Beyond this general structure, several object classes define
 their own XML DTD fragments for filling in the ANY placeholders
-in the DTD above. 
-<!-- FIXME: explain custom tags in <child> vs custom tags in  <object> --> 
-These are explained in their own sections, see 
+in the DTD above. Note that a custom element in a &lt;child&gt;
+element gets parsed by the custom tag handler of the parent
+object, while a custom element in an &lt;object&gt; element
+gets parsed by the custom tag handler of the object. 
+</para>
+<para>
+These XML fragments are explained in the documentation of the
+respective objects, see 
 <link linkend="GtkWidget-BUILDER-UI">GtkWidget</link>,
 <link linkend="GtkContainer-BUILDER-UI">GtkContainer</link>,
 <link linkend="GtkDialog-BUILDER-UI">GtkDialog</link>,